公司开发微信小程序,pm想实现如下需求:
用手指缩放图片。其实在实现这个需求以前,并不知道,微信公众号以及微信小程序里面有一个原生的api就自带这个特效,而且微信朋友圈也是用的这个api。wx.previewImage,就是它。预览图片。除了不能预览开发环境的本地电脑的图片外,你手机真机的图片,以及http服务器上的图片都是可以预览的,而且缩放功能做得很流畅。下面就说说如何用js来实现这个功能吧。
文章里面的思路参考此文章:链接描述
先上源码,然后在逐步剖析:
Page({
data: {
touch: {
distance: 0,
scale: 1,
baseWidth: null,
baseHeight: null,
scaleWidth: null,
scaleHeight: null
}
},
touchstartCallback: function(e) {
// 单手指缩放开始,也不做任何处理
if(e.touches.length == 1) return
console.log('双手指触发开始')
// 注意touchstartCallback 真正代码的开始
// 一开始我并没有这个回调函数,会出现缩小的时候有瞬间被放大过程的bug
// 当两根手指放上去的时候,就将distance 初始化。
let xMove = e.touches[1].clientX - e.touches[0].clientX;
let yMove = e.touches[1].clientY - e.touches[0].clientY;
let distance = Math.sqrt(xMove * xMove + yMove * yMove);
this.setData({
'touch.distance': distance,
})
},
touchmoveCallback: function(e) {
let touch = this.data.touch
// 单手指缩放我们不做任何操作
if(e.touches.length == 1) return
console.log('双手指运动')
let xMove = e.touches[1].clientX - e.touches[0].clientX;
let yMove = e.touches[1].clientY - e.touches[0].clientY;
// 新的 ditance
let distance = Math.sqrt(xMove * xMove + yMove * yMove);
let distanceDiff = distance - touch.distance;
let newScale = touch.scale + 0.005 * distanceDiff
// 为了防止缩放得太大,所以scale需要限制,同理最小值也是
if(newScale >= 2) {
newScale = 2
}
if(newScale <= 0.6) {
newScale = 0.6
}
let scaleWidth = newScale * touch.baseWidth
let scaleHeight = newScale * touch.baseHeight
// 赋值 新的 => 旧的
this.setData({
'touch.distance': distance,
'touch.scale': newScale,
'touch.scaleWidth': scaleWidth,
'touch.scaleHeight': scaleHeight,
'touch.diff': distanceDiff
})
},
bindload: function(e) {
// bindload 这个api是<image>组件的api类似<img>的onload属性
this.setData({
'touch.baseWidth': e.detail.width,
'touch.baseHeight': e.detail.height,
'touch.scaleWidth': e.detail.width,
'touch.scaleHeight': e.detail.height
})
}
})
因为参考的别人的博文写的,原本想大致把源码贴出来,好自己以后作为笔记查看,但发布未成功,所以还是多写一些思路吧。
也就是说,思路是借鉴的,实际是自己操作的。
其实这个特效主要用到了touch三兄弟事件。
更主要的还是touchmove。
首先,我们需要获得用户的触摸事件。只有获得了这个事件,小程序才能得知用户希望缩放图片,同时确定图片的缩放倍数。
我们发现微信提供 touchmove 事件,在用户触摸屏幕并在屏幕上移动手指时,这个事件就会被触发。
手势动态检测
手势缩放的核心思想是:根据两只手指相对距离的变化来对图片进行放大或缩小。因此,我们需要知道两只手指相对距离的变化,才能做到良好的缩放体验。
touchmove 事件可以实现的功能,大致可以总结为:
手指在屏幕上进行移动时,对应的组件上就会以 16 ms 一次的频率不断触发 touchmove 事件;
手指离开屏幕后,则会触发 touchend 事件。
touchmove 事件所包含的事件对象中有一个 touches 属性,此属性为当前停留在屏幕中的触摸点信息的数组。触摸点的信息包括:
identifier:触摸点的标志符;
pageX 和 pageY:距离文档左上角的距离;
clientX 和 clientY:距离屏幕可显示区域左上角距离。
我们可以通过不断获取 clientX 和 clientY 数据的方式,来确定手指在屏幕上的位置变化。
let xMove = e.touches[1].clientX - e.touches[0].clientX;
let yMove = e.touches[1].clientY - e.touches[0].clientY;
distance 变量即为两只手指之间的距离。在 touchmove 被触发的时候,小程序就会计算一次 distance。
我们为新的 distance 变量定名为 newDistance,相应地,旧变量定名为 oldDistance。
之后,我们设定一个新的变量 distanceDiff = newDistance - oldDistance,它反映两次 touchmove 触发瞬间,两根手指相对距离的变化值。
distanceDiff 为正数时,表示两指间距离在变大,图片需要被放大;反之,则代表两指间距缩小,图片需要被缩小。
图片动态缩放
到这里,我们已经可以探测用户的手指距离变化了。接下来,我们需要根据用户的手势,确定图片缩放倍数,然后根据倍数缩放图片。
首先,要确定 distance 的变化值与图片放大或缩小的变化率相关联的规则。
我们将图片正常显示时的尺寸定为基准值,存放于变量 baseWidth 和 baseHeight 中。图片需要放大的倍数设置为变量 scale,它的初始值和最小值为 1,最大值可根据需要来设置。
经过多次试验,我们最后确定了一个公式:
newScale = oldScale + 0.005 * distanceDiff
在每次 touchmove 被触发后,通过探测手指距离变化而得到的数据,来得到图片按比例缩放后的高宽值。
scaleWidth = scale * baseWidth;
scaleHeight = scale * baseHeight;
wxml文件对应如下,就不做解释了:
<view class="container">
<view bindtouchmove="touchmoveCallback" bindtouchstart="touchstartCallback">
<image src="../../resources/pic/cat.jpg" style="width: {{ touch.scaleWidth }}px;height: {{ touch.scaleHeight }}px" bindload="bindload"></image>
</view>
</view>
写到这里发现,就算小程序用不了这个js,我的ht5页面也是可以用的,哈哈。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。